home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 52 / Amiga Format AFCD52 (Issue 136, May 2000).iso / -serious- / programming / other / mesa / mesa-glut / mesa-glut.readme < prev    next >
Text File  |  2000-02-23  |  6KB  |  177 lines
  1. Short:    OS-specific toolkit for Mesa 3.1 (src+binary 68030+68881)
  2. Author:   unknown [ported to Mesa: Niels.Froehling@Informatik.Uni-Oldenburg.DE (Niels Froehling)]
  3. Uploader: Niels.Froehling@Informatik.Uni-Oldenburg.DE (Niels Froehling)
  4. Type:     util/libs
  5. Requires: ixemul
  6.  
  7.  Based upon the first try of Jarno.
  8.  
  9. ----
  10.  
  11. This directory and its subdirectories contains the OpenGL Utility
  12. Toolkit (GLUT) distribution.  See the NOTICE for legal terms.
  13.  
  14. VERSION:
  15.  
  16. Release 3.7, May 7, 1998.
  17.  
  18. SUPPORTED PLATFORMS:
  19.  
  20. This distribution should compile for:
  21.  
  22.   o  Microsoft Windows 95 or Windows NT with SGI OpenGL for Windows
  23.      (aka Cosmo OpenGL) and/or Microsoft OpenGL 1.1.
  24.   
  25.   o  SGI workstation running IRIX 5.2 or higher supporting OpenGL,
  26.      including 64-bit and N32 support IRIX 6.1, 6.2, 6.3, 6.4, and
  27.      6.5.
  28.  
  29.   o  DEC Alpha workstation running OSF/1 and OpenVMS with Open3D
  30.      layered product.
  31.  
  32.   o  IBM RS/6000 workstations running AIX with OpenGL support.
  33.  
  34.   o  Metro Link's Metro OpenGL for Linux.
  35.  
  36.   o  Template Graphics Software's OpenGL for Sun workstations.
  37.  
  38.   o  Mesa 2.x (and 1.x) for Unix workstations, including Linux PCs
  39.      and SunOS 4.1.x.
  40.  
  41. MICROSOFT WINDOWS 95 and NT BUILD INSTRUCTIONS:   <-- IMPOARTANT!
  42.  
  43. Read the "README.win" accompanying file.  The short instructions if you
  44. have Microsoft's Visual C++ compiler is to run the "glutmake" batch
  45. file.  You may need to edit "glutwin32.mak" to indicate your compiler
  46. location.
  47.  
  48. MAKEFILE GENERATION TO BUILD GLUT:                <-- IMPORTANT!
  49.  
  50. Use "mkmkfiles.sgi" to put Makefiles using the SGI Makefile conventions
  51. in place.  Use "mkmkfiles.imake" to put Makefiles generated from
  52. Imakefiles in place.  Run one of these two commands in this directory,
  53. then do a "make".
  54.  
  55. FREQUENTLY ASKED QUESTIONS ABOUT GLUT:
  56.  
  57. See FAQ.glut
  58.  
  59. CONTENTS OVERVIEW BY DIRECTORY:
  60.  
  61.   GL - GLUT interface header files
  62.  
  63.   lib - source code for GLUT libraries
  64.  
  65.      glut - GLUT library implementation
  66.  
  67.      mui - Tom Davis's GLUT-based micro-UI user interface library
  68.  
  69.      gle - Linas Vepstas's GLE Tubing & Extrusions library
  70.  
  71.      fglut -     GLUT FORTRAN bindings (IRIX only)
  72.      glut.n32 -  "N32" version of the GLUT library (IRIX only).
  73.      fglut.n32 - "N32" version of the GLUT library (IRIX only).
  74.      glut.n64 -  64-bit version of the GLUT library (IRIX only).
  75.      fglut.n64 - 64-bit version of the GLUT library (IRIX only).
  76.      mui.n32 -   "N32" version of micro-UI library (IRIX only).
  77.      mui.n64 -   64-bit version of micro-UI library (IRIX only).
  78.      gle.n32 -   "N32" version of GLE Tubing & Extrusions library (IRIX only).
  79.      gle.n64 -   64-bit version of GLE Tubing & Extrusions library (IRIX only).
  80.  
  81.   test - test programs
  82.   
  83.       glut - GLUT library tests
  84.  
  85.       mui - micro-UI library test
  86.  
  87.   progs - programs using GLUT
  88.  
  89.      examples - misc. GLUT examples
  90.  
  91.      redbook - examples from the OpenGL Programming Guide ported to GLUT
  92.  
  93.      advanced - GLUT examples demonstrating advanced OpenGL rendering
  94.         techniques.  The programs are largely based on the SIGGRAPH '96
  95.     course taught by David Blythe and Tom McReynolds.
  96.  
  97.      contrib - contributed GLUT examples
  98.  
  99.      demos - more involved OpenGL demos using GLUT
  100.  
  101.      fortran - GLUT FORTRAN examples
  102.  
  103.      glc - An example of using OpenGL's Character Rendering API
  104.     included in IRIX 6.2 and beyond.
  105.  
  106.      inventor - Two GLUT-based Open Inventor examples.
  107.  
  108.      mesademos - Ports to GLUT of programs developed by Brian Paul
  109.         that are distributed with Mesa.
  110.  
  111.      texfont - Tools and demos for using texture mapped fonts.
  112.  
  113.      tiff - Examples of using Sam Leffler's libtiff library for
  114.         reading, display, and writing TIFF image files.
  115.  
  116.      ada - Examples using the GLUT ADA binding.
  117.  
  118. DOCUMENTATION:
  119.  
  120. See the other README files in this directory.  There is a complete
  121. specification for GLUT API version 3 in PostScript available by
  122. anonymous ftp accompanying this distribution.  GLUT includes a full set
  123. of nroff man pages for the GLUT API version 3.  nroff man pages for
  124. GLE are also included.
  125.  
  126. ACCOMPANYING DATA FILES:
  127.  
  128. Another separate GLUT data distribution contains a "data" subdirectory
  129. containing large data files used by some of the examples in the
  130. "progs/advanced" subdirectory.  See the file "progs/advanced/README"
  131. for more details.
  132.  
  133. GLUT MAILING LIST:
  134.  
  135. To subscribe to the GLUT mailing list, send an electronic mail message
  136. with the word "subscribe" in the first line of the message to
  137. glut-request@perp.com  Messages intended for the GLUT mailing list can
  138. be sent to glut@prep.com
  139.  
  140. A SHAMELESS BUT HOPEFULLY HELPFUL PLUG:
  141.  
  142. I've written a book titled "Programming OpenGL for the X Window System"
  143. (ISBN: 0-201-48359-9) published by Addison-Wesley.  It includes both a
  144. complete tutorial and documentation for GLUT, as well as a full
  145. explanation of using OpenGL with the X Window System's Xlib and
  146. Xt/Motif interfaces.  If you use GLUT, I believe you'll find this
  147. book very informative.  See:
  148.  
  149.   http://reality.sgi.com/mjk/OpenGLforX.html
  150.  
  151. BUG REPORTING:
  152.  
  153. Send bug reports by electronic mail to mjk@nvidia.com (I now work
  154. for NVIDIA Corporation, not Silicon Graphics).
  155.  
  156. Questions of a general interest about GLUT will be answered on the
  157. comp.graphics.api.opengl newsgroup.
  158.  
  159. ACKNOWLEDGEMENTS:
  160.  
  161. Much thanks to OpenGL engineers at DEC, IBM, Microsoft, SGI, Sun, and
  162. TGS.  Of particular mention are Brian Paul from the University of
  163. Wisconsin, Nate Robins at the Univeristy of Utah, and Craig Groeschel
  164. of Metro Link Inc. for helping me ensure the portability of this code
  165. to non-SGI graphics platforms.  Also thank you to GLUT users who
  166. supplied me with feedback and bug fixes.
  167.  
  168. Nate Robin's effort to combine his Win32 GLUT with GLUT 3.5 were most
  169. excellent.  Tom Davis contributed the micro-UI library.  GLUT 3.5's
  170. testing on PCs was greatly aided by Petri Nordlund, Brian Buchner,
  171. Leath Muller, Stephen Speicher, and I've probably missed others.  Henk
  172. Kok is responsible for the several way cool demos in GLUT 3.5.  Thanks
  173. for your help!
  174.  
  175. - Mark Kilgard
  176.   mjk@sgi.com
  177.